////  Dynamic Reticle/Crosshair Mod  ////  

////  Автор: DJ-LEXX || Версия мода: 1.1.1 || Версия ReadMe: 1.1.1 || Дата релиза: 2-е Августа, 2024 || Дата последнего обновления: 22-е Мая, 2025  ////



//// КАСАТАЛЬНО ИЗДАНИЯ ИГРЫ: ////  

Мод сделан для LEGACY издания игры. Enhanced издание не поддерживается.



////  ОПИСАНИЕ:  ////  

Если вы вдруг поймали себя на мысли, что стандартное перекрестье прицела вам наскучило из-за своей статичности/неподвижности, этот мод может несколько разнообразить ощущения от игрового процесса. Мод добавляет динамическое перекрестье прицела, которое реагирует на движения вашего персонажа, движения камеры и стрельбу из оружия также как и в большинстве шутеров. Также мод добавляет анимированный элемент интерфейса перезарядки оружия и стилизованный индикатор боезапаса рядом с прицелом, который позволяет следить за количеством патронов без необходимости смотреть в правый верхний угол экрана. Некоторые функции мода можно изменить/отключить/включить в меню настроек данного мода.



////  ФУНКЦИИ:  ////  

- Новое перекрестье прицела аналогичное тем, что существуют в других шутерах.

- Перекрестье расширяется и сужается в зависимости от ваших действий (ходьба, бег, движения камеры, стрельба)

- При перезарядке оружия, появляется анимированный индикатор в центре экрана (Аналогичный тому, что есть в игре World War Z)

- Индикатор боезапаса рядом с перекрестьем при прицеливании (Аналогичный тому, что можно встретить в игре World War Z)

- Эффект параллакса для перекрестья и других элементов интерфейса этого мода (Аналогичный тому, что есть у прицела в ребуте COD: Modern Warfare 3 2023-го года)

- Кастомная динамическая прицельная точка (custom dot) с возможностью смены цвета.

- Меню настроек мода, где можно поменять/отключить/включить некоторые функции



////  НЕОБХОДИМО УСТАНОВИТЬ ДЛЯ РАБОТЫ МОДА:  ////

ВНИМАНИЕ! Начиная с обновления GTAV 3258, Rockstar все испортила, так что стабильная версия ScriptHookVDotNet от Crosire больше не работает. Если ваша сборка игры новее 3179, вам придется установить последнюю версию nightly ScriptHookVDotNet и использовать ее до тех пор, пока Crosire не выпустит новую стабильную сборку SHVDN. Но если вы играете на 3179 или даже более раннем билде игры, просто используйте последнюю стабильную версию SHVDN.

- LemonUI (SHVDN2 версия!): https://www.gta5-mods.com/tools/lemonui/download/129289

- Последний ScripthookV: http://www.dev-c.com/gtav/scripthookv

- Последний ScriptHookVDotNet (для версии игры 3179 и ниже): https://github.com/crosire/scripthookvdotnet/releases

- Последний ScriptHookVDotNet.Nightly (для версии игры 3258 и выше): https://github.com/scripthookvdotnet/scripthookvdotnet-nightly/releases

- OpenIV или CodeWalker RPF Explorer: https://openiv.com/



////  УСТАНОВКА:  ////

1) Положите файл DynamicReticle.dll из архива в папку по адресу: "GTAV/scripts".

2) С помощью OpenIV (или CodeWalker RPF Explorer) в режиме редактирования (edit mode), пройдите по адресу "GTAV\mods\update\update.rpf\x64\textures\script_txds.rpf" и положите туда файл "DynamicReticle.ytd" из архива, после чего закройте OpenIV (или RPF Explorer).

3) Запустите игру и в меню паузы перейдите в "НАСТРОЙКИ > Видео > Прицел оружия" и установите значение "Простой".

ПРИМЕЧАНИЕ: Если вы пропустите шаг "2" мод все-равно будет работать, однако в настройках мода доступен будет только режим рендеринга "Overlay". Также каждые 24 часа (реального времени) в игре будет всплывать окно с напоминанием о необходимости выполнить полную установку мода. Если вы хотите, чтобы режим рендеринга "Internal" был также доступен, не пропускайте шаг "2". Для информации по режимам рендеринга, прочитайте пункт "РЕЖИМЫ ОТРИСОВКИ/РЕНДЕРИНГА" ниже.



////  РЕЖИМЫ ОТРИСОВКИ/РЕНДЕРИНГА:  ////

Я сделал опцию выбора режима отрисовки графических элементов мода, где можно выбрать внутренний ("Internal") или оверлейный ("Overlay") режим.
"Overlay" режим отрисовывает спрайты, находящиеся в папке по адресу GTA/scripts/DynamicReticle на вашем харде, используя DirectX метод. В этом режиме спрайты выглядят хуже, а также могут мерцать при нестабильном фреймрейте. Движения анимированных элементов мода могут также быть прерывистыми местами. Этот режим я просто использовал во время разработки мода и дебага для удобства. Посему я не рекомендую использовать этот режим.
"Internal" режим рендерит спрайты из внутриигрового архива родным для GTA методом, подобно тому, как рендерятся официальные элементы интерфейса и прочие текстуры.
Спрайты в этом режиме отрисовываются довольно качественно, без мерцаний, а их движения при анимации выглядят очень плавно. Используйте режим "Internal" для наилучшего качества и ощущения от мода.



////  ИСПОЛЬЗОВАНИЕ:  ////

Нажмите "Ctrl + X" (английская раскладка) на клавиатуре, чтобы открыть меню мода и внести изменения в настройки мода при необходимости.

Имейте в виду. При первом запуске мода, папка "DynamicReticle" будет создана по адресу "GTAV/scripts", после чего, туда будут распакованы все необходимые ресурсы из .DLL файла мода. Эти ресурсы нужны для работы режима рендеринга "Overlay". Также в этой же папке будет создан файл настроек, куда будут сохранятся все изменения, сделанные вами в меню настрое мода.



////  ИЗВЕСТНЫЕ ПРОБЛЕМЫ:  ////

- Если у вас в руках оружие и вы откроете внутриигровой веб-браузер (тот, что в телефоне игрока), то прицел будет виден поверх него. Также он будет виден и поверх других Scaleform интерфейсов, таких как хакерские мини-игры и им подобных. Если это вас будет сильно напрягать, то просто поставьте галочку в опции "Visible on aim only" в меню настроек мода, а лучше всего просто убирайте оружие прежде, чем открыть внутриигровой веб-браузер.

- Когда вы целитесь в режиме от первого лица через прицел "Микро-ПП" или "Тактического ПП" (такое только именно с этими двумя стволами), то перекрестье прицела не исчезает. Чтобы пофиксить это, просто установите на данное оружие коллиматорный прицел и все будет как надо. Также, такая "проблема" может возникнуть и на другом оружии ЕСЛИ ТОЛЬКО вы изменили дефолтные значения FOV оружия в сторону его увеличения (триггер исчезания перекрестия просто не будет срабатывать, если при прицеливании от первого лица угол обзора камеры будет слишком широким).

- Прицел и интерфейсные элементы мода не будут отображаться у оснащенного оружием транспорта, такие как танки, БТРы и т.п. а также, если вы стоите за турелью, например, гантрака "Technical". Там есть свои нюансы в плане реализации и исправления этого момента пока не планируются. Включайте стандартный прицел в меню мода, если часто используете подобную технику в игре, либо привыкайте стрелять из пушек и турелей на глаз. Пока так.



////  ЧАСТЫЕ ВОПРОСЫ (FAQ):  ////

- Вопрос: Прицел не посередине и смещен в сторону, что делать?

+ Ответ: Если прицел не находится четко посередине и куда-то смещен, значит разрешение вашего экрана не входит в список тех, для которых я настраивал оффсеты. Поэтому перейдите в подменю "Troubleshooting" в нижней части меню настроек и выберете пункт "Calibrate position", после чего отрегулируйте положение прицела так, чтобы он был четко посередине, опираясь на стандартную прицельную метку. Результат калибровки будет сохранен в .INI файл для текущего разрешения экрана.

- Вопрос: Установил .ytd файл, но вылетает "Not good" сообщение и режим рендеринга "Internal" не доступен.

+ Ответ: Если вы установили файл .ytd правильно, но все-равно вылетает сообщение "Not good", это означает, что ваша игра загружается медленнее, чем ожидалось, из-за более медленного жесткого диска или из-за большого количества установленных .rpf модов, и загрузка .ytd файла занимает больше времени, чем стандартное время ожидания проверки наличия .ytd файла. Поэтому мод считает, что вы еще не установили .ytd файл. Если это произойдет, перейдите в подменю "Troubleshooting" в нижней части меню настроек и увеличьте .ytd checking timeout. По умолчанию таймаут составляет 2 секунды, но вы можете увеличить его до 30 секунд. В большинстве проблемных случаев будет достаточно 10-20 секунд. Имейте в виду, пока не истечет таймаут, прицел и прочие интерфейсные элементы этого мода не появятся на экране, поэтому не ставьте слишком большой таймаут, например, в 20 секунд, если вам достаточно и 5 секунд, иначе будете без необходимости ждать лишнее время, прежде чем отобразится интерфейс мода.



ПРИМИТЕ ВО ВНИМАНИЕ: Этот мод я сделал для себя и просто делюсь им с вами. Он предоставляется вам "КАК ЕСТЬ". Никакие пожелания или просьбы по расширению функционала мода не принимаются, если это только не что-то, что мне очень понравится и я сам захочу это внедрить. Однако любые замечания по технической части мода и вопросы багов, я конечно же вниманием не обойду и помогу. Отвечаю обычно с задержкой от 1 до нескольких дней (на своей странице на gta5-mods.com).



////  СПИСОК ИЗМЕНЕНИЙ:  ////

1.0

 -Релиз
 
1.1

 -Поднастроил вертикальную динамику custom dot'а, чтобы он больше подпрыгивал с самого первого выстрела при стрельбе из малокалиберных пистолетов.

 -Добавил дополнительной рандомизированной горизонтальной динамики для custom dot'а при стрельбе из малокалиберных пистолетов и дробовиков.

 -Значительно увеличил динамический диапазон прицела при стрельбе из дробовиков, чтобы игрок чувствовал, что он действительно стреляет из чего-то мощного.

 -Немного увеличил динамический диапазон при первых выстрелах из малокалиберных пистолетов.

 -Исправил корявое и резкое исчезание прицела при убирании пистолета или дробовика. Теперь прицел затухает плавно, как и было задумано.

 -Исправил косяк с зависящей от фреймрейта скоростью затухания/появления прицела и custom dot'а. 

 -Исправил косяк с кратковременным появлением верхней линии прицела при убирании пистолета. 

 -Исправил косяк с некорректным отображением боезапаса у ammo hud'а после перезарядки, в случае, когда количество патронов в наличии у игрока было меньше, чем вместимость магазина до момента перезарядки.

 -Добавил возможность отключить/включить динамический прицел в меню настроек (Опция не влияет на отображение custom dot'а).

 -Добавил возможность отключить/включить динамику отдачи для custom dot'а.
 
1.1.1 - Небольшой апдейт

 -Добавил "Troubleshooting" (Устранение неполадок) подменю внизу меню настроек.

 -Добавил возможность изменить (увеличить) время ожидания перед процессом проверки наличия .ytd файла в "Troubleshooting" подменю (Актуально для тех, кто испытывал проблемы с обнаружением модом .ytd файла, несмотря на правильную установку этого файла)
 
 -Переместил опцию калибровки прицела "Calibrate position" в "Troubleshooting" подменю.
 
 -Изменил опцию включения/отключения ammo hud на трёхпозиционную, добавив возможность скрывать ammo hud во время прицеливания через мушку/коллиматор в режиме от первого лица. Новый параметр опции называется "DISABLE FOR ADS".
 
 Заметка обновления 1.1.1: Изменения были внесены только в сам скрипт, .ytd файл изменен не был.


 
////  КОНТАКТЫ:  ////

- Моя страница на gta5-mods.com: https://www.gta5-mods.com/users/DJ-LEXX

- Мой Steam: https://steamcommunity.com/id/dj-lexx



////  CREDITS:  ////  

DJ-LEXX - Author
justalemon - LemonUI
crosire & kagikn - ScriptHookVDotNet
Alexander Blade - ScriptHookV